Importowanie danych z platformy Ivanti Neurons

Dane urządzeń i użytkowników można importować z platformy Ivanti Neurons w ramach importu zaplanowanego. Najpierw należy zarejestrować nową aplikację na platformie Ivanti Neurons i utworzyć połączenie danych z instancją Ivanti Neurons, a następnie użyć połączenia Import danych, aby zaplanować import.

Utworzony łącznik do platformy Ivanti Neurons nadaje się wyłącznie do importowania danych. Nie można go używać do innych celów, takich jak wysyłanie zapytań czy wyszukiwanie na żywo w Service Desk.

Konfigurowanie takiego importu to zaawansowana funkcja przeznaczona dla osób posługującymi się swobodnie takimi technologiami, jak Postman, JSON i OData, w ramach identyfikowania wymaganych parametrów połączenia. Aby uzyskać pomoc od Ivanti Professional Services w korzystaniu z tej funkcji, należy skontaktować się ze swoim dostawcą.

Więcej informacji o połączeniach danych zawiera sekcja Połączenia danych, a więcej informacji o komponencie Import danych można znaleźć w sekcji Importowanie danych.

Aby utworzyć połączenie danych z Ivanti Neurons:

1. Utwórz nową niestandardową rejestrację aplikacji na platformie Ivanti Neurons. Zapewni to Adres URL tokena dostępu, Identyfikator klienta oraz Klucz tajny klienta wymagane w dalszej części procedury.

Więcej informacji na temat tworzenia nowej niestandardowej rejestracji aplikacji można znaleźć w oddzielnym Centrum pomocy Ivanti Neurons.

2. Uruchom komponent Połączenia danych. Następnie w drzewie Połączenia danych wybierz łącznik Ivanti Neurons, a na liście Działania kliknij opcję Nowe połączenie.
   Pojawi się nowe połączenie.
3. Wpisz nazwę połączenia, a następnie naciśnij klawisz Enter.
   Ta nazwa stanie się nazwą modułu używanego podczas konfigurowania źródła importu danych.
4. W siatce Właściwości wpisz w polu URL adres URL swojego dzierżawcy Ivanti Neurons, na przykład https://example.ivanticloud.com/.
5. Opcja Dostawca jest ustawiona na OAuth2 i nie można tego zmienić. Wybierz wartości dla opcji Adres URL tokena dostępu, Identyfikator klienta oraz Klucz tajny klienta. Pozostaw puste pole Zakres.
6. Kliknij , aby przetestować połączenie.
   Jeżeli połączenie nie powiedzie się, sprawdź powyższe szczegóły, a następnie ponownie przetestuj połączenie.
7. Kliknij przycisk , aby zapisać nowe połączenie.

Po utworzeniu połączenia z platformą Ivanti Neurons można tworzyć połączenia różnego typu, aby uzyskać dostęp do różnych typów danych dostępnych w Ivanti Neurons, na przykład do urządzeń lub użytkowników.

W ramach konfiguracji importu należy określić unikatowy identyfikator importowanych elementów. Jednak w pewnych okolicznościach znalezienie identyfikatora, który jest unikatowy dla wszystkich importowanych elementów, może być niemożliwe. Przykładowo w przypadku importowania urządzeń można użyć atrybutu „Nazwa urządzenia” jako unikatowego identyfikatora dla urządzeń z systemem Windows. Nie można tak jednak zrobić z urządzeniami Apple, gdyż tutaj może być konieczne użycie innego identyfikatora, na przykład numeru seryjnego. W takiej sytuacji należy utworzyć różne operacje importu danych dla różnych typów urządzeń, wybierając wyłącznie wymagane elementy za pomocą filtra.

Nie można utworzyć filtra dla danych Neurons w systemie Service Desk. Zamiast tego należy je odfiltrować za pomocą zapytania OData stanowiącego część adresu URL punktu końcowego podczas tworzenia typu połączenia, zgodnie z poniższym opisem. Zamiast podawać adres URL punktu końcowego, na przykład api/discovery/v1/device, można podać api/discovery/v1/device?$filter=manufacturer eq 'Apple'.

Aby utworzyć nowy typ połączenia:

1. W drzewie Połączenia danych kliknij utworzone wyżej połączenie, a następnie na liście Działania kliknij opcję Nowy typ połączenia.
   Pojawi się nowy typ połączenia.
2. Wpisz nazwę typu połączenia, a następnie naciśnij klawisz Enter.
3. W siatce Właściwości wypełnij następujące właściwości typu połączenia.
   Adres URL punktu końcowego: ścieżka do punktu końcowego, z którym się łączysz, na przykład api/discovery/v1/device lub api/discovery/v1/user. Jeśli nie chcesz importować wszystkich dostępnych danych, musisz dołączyć filtr OData jako część adresu URL, ponieważ filtra nie można dodać później w ramach konfiguracji importu danych.
   Nazwa klasy TPS: wpisz nazwę obiektu.
   Opis klasy TPS: opcjonalny opis.
4. Kliknij obok opcji Mapy atrybutów.
   Zostanie wyświetlone okno dialogowe Zarządzaj mapowaniem, umożliwiające zapisanie mapowań na platformie Ivanti Neurons w jednostkach OData, które mają być pobierane w atrybutach w łączniku Service Desk. Te jednostki OData będą następnie dostępne do zaimportowania do systemu Service Desk za pomocą komponentu Import danych.

Aby uzyskać dostęp do urządzeń platformy Ivanti Neurons za pomocą programu Menedżer pulpitu, należy dodać mapowanie atrybutu Identyfikator Neurons, ponieważ jest używany do identyfikacji urządzeń. Więcej informacji można znaleźć w sekcji Łączenie z Ivanti Neurons w celu zarządzania pulpitem.

5. Kliknij opcję Dodaj mapowanie.
   Zostanie wyświetlone okno dialogowe Definiowanie atrybutu mapowania.
6. Pobierz odpowiednie urządzenie lub rekord użytkownika z platformy Ivanti Neurons, na przykład z wykorzystaniem technologii Postman.
7. Wprowadź dane w polach Nazwa i Tytuł w oknie dialogowym Definiowanie atrybutu mapowania, a następnie wprowadź opcjonalny Opis.
8. W narzędziu Postman skopiuj nazwę jednostki importowanej za pomocą tego mapowania i wklej ją do pola Mapowanie.
9. Kliknij przycisk OK.
   Mapowanie zostanie dodane do listy w oknie dialogowym. Jeśli użyjesz znaku / w celu uzyskania dostępu do jednostek w strukturze drzewa, znak / zostanie zmieniony na . w kolumnie Mapowanie odpowiedzi. Kolumna Mapowanie zapytań zawiera wartość wysyłaną jako adres URL punktu końcowego, natomiast kolumna Mapowanie odpowiedzi zawiera ścieżkę do żądanych danych.
10. Jeśli jednostka ma format tablicy (na przykład użytkownik może mieć kilka adresów e-mail i chcesz wybrać jeden z nich), wprowadź indeks wymaganego elementu w kolumnie Mapowanie odpowiedzi w [nawiasach kwadratowych] przed separatorem .

Numeracja indeksu rozpoczyna się od 0. Aby zatem uzyskać dostęp do pierwszego adresu e-mail z tablicy, wpisz Emails[0].Email w kolumnie Mapowanie odpowiedzi.

11. Powtórz czynności w odniesieniu do innych atrybutów, do których chcesz uzyskać dostęp.
12. W oknie dialogowym Zarządzaj mapowaniem ustaw opcję Czy nazwa? na Tak dla atrybutu zawierającego unikatową wartość, która będzie używana jako nazwa. Następnie kliknij przycisk OK.
    Okno dialogowe Zarządzaj mapowaniem zostanie zamknięte.
13. Na siatce właściwości typu połączenia ustaw Klucz podstawowy.
14. Na liście Działania kliknij polecenie Testuj mapę.
    Pojawi się siatka z wynikiem mapowań dla pierwszych 10 zwróconych zapisów.

Po zapisaniu zmian w typie połączenia można dodawać i usuwać mapowania (inne niż Jest nazwa i Klucz podstawowy), ale nie można edytować istniejących mapowań.

15. Kliknij , aby zapisać zmiany.

Teraz, gdy połączenie z Ivanti Neurons jest już gotowe, można go użyć do utworzenia importu danych. Import danych mapuje dane zdefiniowane w powyższych mapowaniach typów łączników na odpowiednie atrybuty obiektów systemu Service Desk.

Aby utworzyć konfigurację importu:

1. W drzewie Mapowania importu składnika Import danych wybierz folder Zaplanowane importy.
2. Na liście Działania kliknij opcję Nowy zaplanowany import, zdefiniuj wymagany harmonogram, a następnie kliknij
3. W drzewie Konfiguracje importu wybierz właśnie utworzony harmonogram, a następnie na liście Działania kliknij pozycję Nowe mapowanie importu.
   Zostanie wyświetlone okno Nowe mapowanie importu.
4. Z listy Moduł źródłowy wybierz moduł, który został utworzony podczas ustawiania nazwy połączenia danych.
5. Z listy Źródłowy obiekt biznesowy wybierz obiekt, który został utworzony podczas ustawiania nazwy typu połączenia danych.
6. W sekcji Cel wybierz Moduł oraz Obiekt biznesowy, do którego chcesz zaimportować dane Neurons.
7. Przeciągnij atrybuty źródłowe, z których chcesz zaimportować dane, na odpowiednie atrybuty docelowe.
8. Na liście Atrybuty docelowe wybierz atrybut, który ma być używany jako klucz, a następnie na liście Działania kliknij pozycję Ustaw docelowy atrybut klucza.
   Zostanie wyświetlone okno dialogowe Docelowy atrybut klucza.
9. Wybierz atrybut, który chcesz ustawić jako atrybut klucza, a następnie kliknij przycisk OK. Informacje na temat atrybutów docelowych zawiera rozdział Ustawianie atrybutu klucza docelowego.
10. Wpisz dane w polu Ścieżka pliku dziennika, jeśli jest to wymagane, a następnie kliknij .
    Import danych zostanie zrealizowany zgodnie z harmonogramem.